home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / textual / txt2strg / ReadMe next >
Text File  |  1995-07-02  |  2KB  |  69 lines
  1. Texi2Strong v1.00
  2. ~~~~~~~~~~~~~~~~~
  3.  
  4. texi2strong v1.0 - © 1995 Jochen Scharrlach (jscharrl@ba-stuttgart.de)
  5.  
  6. This program is freeware, i.e. you can freely use and distribute it.
  7. You may not sell this program or distribute modified versions without
  8. having the permission from the author.
  9.  
  10. Usage: perl texi2strng <texinfo-file> <directory>
  11.  
  12. What is Texinfo?
  13. ----------------
  14.  
  15. Texinfo is a documentation system used by many GNU programs like GCC,
  16. Bison, Flex. You can either generate a hypertext documentation (INFO) 
  17. or a printed manual via the TeX-DVI format.
  18.  
  19. General comments
  20. ----------------
  21.  
  22. This script is simply one big hack, there are several features missing
  23. but I was able to convert several Texinfo manuals I was interested in
  24. and for me that's all what counts. Don't look too critical at the 
  25. formatting - !StrongHlp does less formatting than TeXinfo, so it would
  26. be a major job to do this nicely.
  27.  
  28. If you don't know Perl5, don't try to understand the script...
  29.  
  30. To use it under RiscOS 
  31. ----------------------
  32.  
  33. you'll need:
  34. - Perl5 release 1.5 or later (currently, there is only release
  35.   1.0 officially available)
  36. - an archive filing system like !ArcFS of !SparkFS, beacause the script
  37.   generates usually more than 77 files and you can't feed !StrongHlp
  38.   with those files directly (at least it didn't work with StrongHlp v2.02)
  39.  
  40. Before you start, make sure that the variable $RiscOS is "1" (it is set at 
  41. the top of the script). 
  42.  
  43. To use it under Unix
  44. --------------------
  45.  
  46. you'll need:
  47. - Perl 5
  48.  
  49. Set $RiscOS to "0".
  50.  
  51. If you have major trouble
  52. -------------------------
  53.  
  54. If you get warnings , take a look at the result before you send me a bug 
  55. report: some "bugs" have no effect!
  56.  
  57. If you find major bugs, drop me a mail with a description and an example:
  58. jscharrl@ba-stuttgart.de
  59.  
  60. Special thanks to:
  61. ------------------
  62.  
  63. * Larry Wall & friends for writing Perl 
  64. * Luke Taylor & Paul Moore for porting it to RiscOS
  65. * Guttorm Vik for writing a *free* documentation system for RiscOS
  66.  
  67. Enjoy!
  68. 02/07/95 Jochen Scharrlach
  69.